How it works


Welcome acts like a filter for incoming requests. Just before the request reaches the server, Welcome catches the request header and modifies the path accordingly to the information that is provided.

It will

  1. try to find the virtual host for which the request is sent
  2. add the virtual subfolder and index file to the path
  3. check for a missing slash at the end of the path and redirect the request if necessary
  4. run the resulting request through all defined rules which may modify the path
  5. finally pass the modified request to the server

It is important, that rules are processed after the virtual hosting was done. Any path reaching the rules will therefore start with one of the virtual subfolders:

To use Welcome, you just need to create one subfolder for each virtual host. This will include your main website as a virtual host too.